home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / appicon tools / trashmanager / trashmanager.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  17KB  |  294 lines
  1. @database    "TrashManager.guide"
  2. @author        "John Muir"
  3. @(c)        "
  4.  Copyright 1995 John Muir"
  5. @$VER: Trash Manager User Manual 0.93 (7.1.95)
  6. @width 78
  7. @toc Main
  8. @index Index
  9. @node Main "Trash Manager User Manual"
  10.                             @{b}@{u}Trash Manager  v0.93@{uu}
  11.                          
  12.  Copyright 1995 John Muir
  13.                             Written by John Muir@{ub}
  14.                            @{"     DISCLAIMER      " link Disclaimer}
  15.                            @{"    Introduction     " link Introduction}
  16.                            @{"    Requirements     " link Requirements}
  17.                            @{"    Installation     " link Installation}
  18.                            @{" Using Trash Manager " link UsingTM}
  19.                            @{"      Settings       " link Settings}
  20.                            @{"    Release Notes    " link History}
  21.                            @{"    Contact Info     " link Contact}
  22. @endnode
  23. @node Disclaimer "DISCLAIMER"
  24.                                  @{u}@{b}DISCLAIMER@{ub}@{uu}
  25.          The information and the Trash Manager program are provided
  26.          "as is" without warranty of any kind, either expressed or
  27.          implied.  The entire risk as to the accuracy of the
  28.          information herein is assumed by you.  John Muir does not
  29.          warrant, guarantee, or make any representations regarding
  30.          the use of, or the results of the use of, the information
  31.          or the Trash Manager program in terms of correctness,
  32.          accuracy, reliability, currentness, or otherwise.  In no
  33.          event will John Muir be liable for direct, indirect,
  34.          incidental, or consequential damages resulting from any
  35.          defect in the information or the Trash Manager program even
  36.          if he has been advised of the possibility of such damages.
  37.                                   @{b}@{u}FREEWARE@{ub}@{uu}
  38.          Trash Manager is FREEWARE; it may be distributed by any
  39.          means, anywhere.
  40.          Please do not make any changes to the archive.  If Trash
  41.          Manager is distributed in or with any commercial media,
  42.          I would like to be acknowledged for my efforts in the
  43.          production of Trash Manager.
  44. @endnode
  45. @node Introduction "Introducing Trash Manager"
  46.                                 @{u}@{b}Introduction@{ub}@{uu}
  47.           Trash Manager is an App-Icon Trashcan program which runs on
  48.           the Workbench.  Trash Manager creates an Icon which appears
  49.           on the Workbench screen.  The Workbench user can drop other
  50.           icons onto this App-Icon and Trash Manager will delete the
  51.           selected file(s).
  52.           This can be dangerous, so Trash Manager allows you to
  53.           confirm the deletion of each file to make sure that you
  54.           don't delete files that you don't want to.
  55.           Since the program creates an icon on your Workbench, it
  56.           allows you to to choose which icon is used, where it is
  57.           placed and the name to give it.
  58.           All of the settings that you use are saved into the Trash
  59.           Manager icon.
  60. @endnode
  61. @node Requirements "Requirements"
  62.                                 @{u}@{b}Requirements@{ub}@{uu}
  63.           Trash Manager requires Kickstart and Workbench 3.0 or
  64.           above (and a Commodore Amiga 
  65.  home Computer).
  66.           Required libraries and software:
  67.              gadtools.library v39
  68.              locale.library v38
  69.              Workbench
  70.                                  @{u}@{b}Development@{ub}@{uu}
  71.           Trash Manager was developed on an Amiga 3000/25 with 10Mb
  72.           of RAM, and AmigaOS 3.1.  Trash Manager was written in 'C'
  73.           and compiled with SAS/C 6.51.
  74. @endnode
  75. @node Installation "Installing Trash Manager"
  76.                   @{u}@{b}Installing Trash Manager onto Your System@{ub}@{uu}
  77.           The best way to install Trash Manager is by double-
  78.           clicking on the Install Trash Manager icon.  This executes
  79.           an installer script which will copy all of the relevant
  80.           files to the appropriate locations.
  81.           If you don't like the installer, then follow these
  82.           instructions;
  83.           To install Trash Manager onto your hard disk, simply copy
  84.           the TrashManager file and icon to any directory.  The best
  85.           place to put it would be the SYS:WBStartup drawer so that
  86.           Workbench will start Trash Manager every time your start.
  87.           If you are using any language other than english, copy the
  88.           Catalogs/<language>/TrashManager.catalog to
  89.           Locale:Catalogs/<language>/TrashManager.catalog.
  90.           For example, I have installed the french catalog on my
  91.           system;
  92.              copy Catalogs/fran
  93. ais/TrashManager.catalog to
  94.                   Locale:Catalogs/fran
  95.           This completes the installation of Trash Manager.
  96. @endnode
  97. @node UsingTM "Using Trash Manager"
  98.                              @{u}@{b}Using Trash Manager@{uu}
  99.                            Starting Trash Manager@{ub}
  100.           To start Trash Manager, simply double-click on the
  101.           TrashManager program icon from the Workbench, or type
  102.           TrashManager at a Shell prompt.  Trash Manager will create
  103.           an App-Icon on the Workbench.
  104.                          @{b}Opening the Settings Window@{ub}
  105.           Double-Clicking on the App-Icon will cause the Trash
  106.           Manager @{" Settings " link Settings} window to open.
  107.           The Trash Manager Settings window can also be opened from
  108.           @{b}Commodities Exchange@{ub} with the @{b}Show Interface@{ub} button.
  109.                                @{b}Deleting Files@{ub}
  110.           To delete files, simply click on a file on your Workbench,
  111.           and drag it onto the Trash Manager App-Icon.
  112.                             @{b}Confirming Deletions@{ub}
  113.           If the Confirm checkbox is checked on, then a window will
  114.           appear asking you if you want to delete the file that you
  115.           dropped onto the App-Icon.  You are given four choices;
  116.           @{b}Delete@{ub} - delete the current file.
  117.           @{b}All@{ub} - delete the current file and all other files without
  118.                 confirming the others.
  119.           @{b}Skip@{ub} - skip the current file.
  120.           @{b}Cancel@{ub} - cancel the entire operation.
  121.                           @{b}Deleting Protected Files@{ub}
  122.           Should a file that you have dropped onto the App-Icon be
  123.           delete protected, then if the Protected cycle is set to
  124.           @{b}Ask@{ub}, a window similar to that one above will open giving
  125.           you the same options.  In this case the @{b}All@{ub} button will
  126.           cause Trash Manager to ignore delete protection for all
  127.           files that it is asked to delete at that time.
  128.           If one of the files could not be deleted, a window will
  129.           open decribing the problem with an error message.  You are
  130.           given three choices in response;
  131.           @{b}Skip@{ub} - skip the current file.
  132.           @{b}Retry@{ub} - try deleting the file again.
  133.           @{b}Cancel@{ub} - cancel the entire operation.
  134.           The Retry option is useful if the problem is caused by an
  135.           open Workbench window or another program which has opened
  136.           the file.  You can close the window or the file and press
  137.           Retry to try deleting the file again.
  138.                            @{b}Quitting Trash Manager@{ub}
  139.           There are several ways to quit Trash Manager;
  140.             - Open the Settings window, and choose Quit from the
  141.               Protect menu.
  142.             - Run Trash Manager again.
  143.             - Open Commodities Exchange, choose TrashManager, and
  144.               press the 'Remove' button.
  145. @endnode
  146. @node Settings "Trash Manager Settings"
  147.                            @{u}@{b}Trash Manager Settings@{uu}@{ub}
  148.           The Trash Manager Settings window is opened by double-
  149.           clicking on to the Trash Manager App-Icon on the
  150.           Workbench.
  151.           The Settings window is separated into two parts.  The
  152.           first part labeled @{b}Delete@{ub} contains gadgets pertaining to
  153.           deleting files.  The second part is labeled @{b}App-Icon@{ub}, and
  154.           it contains gadgets pertaining to the App-Icon used on the
  155.           Workbench.
  156.           Keyboard shortcuts are shown as @{u}underlined@{uu} characters.
  157.                                    @{u}@{b}Delete@{ub}@{uu}
  158.           @{b}@{u}P@{uu}rotected@{ub} - a cycle gadget which allows you to determine
  159.              how Trash Manager handles Protected files.  There are
  160.              three choices;
  161.                 @{b}Ask@{ub}    - ask before deleting protected files.
  162.                 @{b}Always@{ub} - always delete protected files.
  163.                 @{b}Never@{ub}  - never delete protected files.
  164.              The requester used when you are @{b}Ask@{ub}ed about a protected
  165.              file is described in the @{" Using Trash Manager " link UsingTM} section.
  166.           @{b}Con@{u}f@{uu}irm@{ub} - a checkbox which controls whether or not Trash
  167.              Manager confirms the delete operation.  The requester
  168.              used to confirm a deletion is described in the
  169.              @{" Using Trash Manager " link UsingTM} section.
  170.           @{b}Enter Direcotry @{u}L@{uu}inks@{ub} - a checkbox which controls whether
  171.              or not Trash Manager recursively deletes the files
  172.              which are within the directory pointed to by a
  173.              directory link.
  174.              @{b}NOTE: If a directory link is dropped directly onto
  175.                 Trash Manager with an Icon, it will not be correctly
  176.                 identified.@{ub}
  177.              Directory links which are sub-directories within a
  178.              directory dropped onto Trash Manager @{i}will@{ui} be
  179.              identified properly.
  180.           @{b}Show @{u}E@{uu}rrors@{ub} - a checkbox which turns on and off the error
  181.              requesters described in the @{" Using Trash Manager " link UsingTM}
  182.              section.
  183.                                   @{b}@{u}App-Icon@{ub}@{uu}
  184.           @{b}@{u}I@{uu}con@{ub} - a string gadget and getfile button combination
  185.              describing the filename for the icon that Trash Manager
  186.              uses as an App-Icon on the Workbench.  Use the getfile
  187.              button to choose the icon with an ASL requester.  If no
  188.              icon is specified then the icon used by Trash Manager
  189.              is used.
  190.              Another way to choose an icon is by dropping it onto
  191.              the App-Icon area in the Settings window.
  192.           @{b}@{u}N@{uu}ame@{ub} - a string gadget describing the name of the App-Icon
  193.              on the Workbench.
  194.           @{b}UnSnaps@{u}h@{uu}ot@{ub} - if this checkbox is checked on, then the X
  195.              and Y integer gadgets and the Get Position button will
  196.              be ghosted, and the App-Icon will appear in the default
  197.              location chosen by Workbench.  Otherwise, the positions
  198.              stored in the X and Y integer gadgets will be used.
  199.           @{b}@{u}X@{ub}@{uu} - this contains the X coordinate of the location given
  200.              to Workbench to place the App-Icon.
  201.           @{b}@{u}Y@{ub}@{uu} - this contains the Y coordinate of the location given
  202.              to Workbench to place the App-Icon.
  203.           If an icon is already in the area used by the App-Icon at
  204.           that X,Y position, then the App-Icon will be placed in the
  205.           default location as if it was @{b}UnSnapshot@{ub}ed.
  206.           @{b}Get Position@{ub} - this button will open a draggable window
  207.              the size of the current App-Icon at the X,Y location.
  208.              You can drag the window to change the X,Y coordinates
  209.              for the App-Icon.  To return to the settings window,
  210.              close this Get Position window, or click on the Trash
  211.              Manager Settings window.
  212.                               @{b}@{u}Buttons and Menus@{ub}@{uu}
  213.           @{b}@{u}S@{uu}ave@{ub} - this button and menu item will cause the settings
  214.              described in the Trash Manager Settings window to be
  215.              saved to the Trash Manager program icon as well as into
  216.              the global variables used within the Trash Manager
  217.              program.  Command-S will also activate the menu item.
  218.           @{b}@{u}U@{uu}se@{ub} - this button and menu item will cause the settings
  219.              described in the Trash Manager Settings window to be
  220.              stored into the global variables in the Trash Manager
  221.              program.  Command-U will also activate the menu item.
  222.           @{b}@{u}C@{uu}ancel@{ub} - this button and menu item will close the Trash
  223.              Manager Settings window and cancel any changes made to
  224.              the gadgets within the window.  The Trash Manager
  225.              Settings windows' close button has the same effect.
  226.              Command-C will also avtivate the menu item.
  227.           @{b}About...@{ub} - this menu item will open a requester telling
  228.              you about Trash Manager.
  229.           @{b}@{u}Q@{uu}uit@{ub} - this menu item will cause Trash Manager to stop
  230.              running.  Any changes to the settings will be discarded
  231.              as with the Cancel operation.  Command-Q will also
  232.              activate the menu item.
  233. @endnode
  234. @node History "Notes on Changes to Trash Manager & things TO DO"
  235.                                    @{u}@{b}History@{ub}@{uu}
  236.          @{b}Version 0.9 (27.12.94)@{ub} - Released on IRC.
  237.          @{b}Version 0.9a (27.12.94)@{ub}
  238.             BUGFIX: Retry button didn't do anything.
  239.             BUGFIX: Window wouldn't come to front if it was already
  240.                open and the icon was double-clicked.
  241.          @{b}Version 0.9b (27.12.94)@{ub}
  242.             BUGFIX: Enter Directory Links text went over the Show
  243.                Error checkbox with some fonts.
  244.          @{b}Version 0.91 (30.12.94)@{ub}
  245.             BUGFIX: UnSnapshot only worked if the icon that was used
  246.                wasn't snapshotted itself.
  247.             BUGFIX: If the tooltypes are updated while the program
  248.                is running, changes to the App-Icon will take effect
  249.                immediately.
  250.             BUGFIX: Settings were not reset to default before reading
  251.                ToolTypes so that NULL ToolTypes didn't result in using
  252.                the default.  This occured after notification of
  253.                changes to the icon only.
  254.             FEATURE: Drop icons onto the App-Icon area in the
  255.                Settings window to set the icon used for the program.
  256.          @{b}Version 0.92 (31.12.94)@{ub}
  257.             BUGFIX: Numerous Enforcer hits while reading ToolTypes,
  258.                and MungWall problems removed.
  259.             FEATURE: Trash Manager is now a Commodity, and responds
  260.                by default to 'lcommand t', as well as to the Show
  261.                and Hide CX commands.  Thanks to John Hughes for the
  262.                suggestion!
  263.          @{b}Version 0.92a (31.12.94)@{ub}
  264.             - Now shows the hotkey in the Settings window titlebar.
  265.             - Small changes getting ready for Localization.
  266.          @{b}Version 0.93 (7.1.95)@{ub} - First public release
  267.             FEATURE: Localized.  French catalog included, with all
  268.               sorts of grammar and word errors.  I need some help
  269.               translating the catalogs.  Please E-Mail me if you're
  270.               interested in volunteering a hour of your time to
  271.               translate the program into your language.
  272.               Trash Manager now requires locale.library v38.
  273.                                     @{u}@{b}To Do@{uu}@{ub}
  274.          - Put a real Get File image in the Icon GetFile button.
  275.            Help anyone?
  276.          - Move files to a trashcan directory instead of deleting.
  277.          - Delete files that are already in this trashcan dir
  278.          or
  279.          - Remember where these files came from and put them back.
  280.          Maybe:
  281.          - Format Disks...  someone get me a decent disk formatter
  282.            and I'll think about it...
  283. @endnode
  284. @node Contact "Where to send your suggestions, comments, bugs, etc."
  285.                            @{b}@{u}Comments?  Suggestions?@{uu}@{ub}
  286.          Send any bug reports, suggestions, gifts to:
  287.          (Internet)     John_Muir@UManitoba.Ca
  288.          (Snail Mail)   John Muir
  289.                         11 Wildwood Park
  290.                         Winnipeg, Manitoba
  291.                         R3T 0C7
  292.                         CANADA
  293. @endnode
  294.